<!--

    Copyright (c) 2005, 2018 Oracle and/or its affiliates. All rights reserved.
    Portions Copyright &#169; [2017-2020] Payara Foundation and/or affiliates.

    This program and the accompanying materials are made available under the
    terms of the Eclipse Public License v. 2.0, which is available at
    http://www.eclipse.org/legal/epl-2.0.

    This Source Code may also be made available under the following Secondary
    Licenses when the conditions for such availability set forth in the
    Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
    version 2 with the GNU Classpath Exception, which is available at
    https://www.gnu.org/software/classpath/license.html.

    SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0

-->
<!-- Portions Copyright [2019] [Payara Foundation and/or its affiliates] -->

<p><a id="ref-virtualserveredit" name="ref-virtualserveredit"></a><a id="GHWEB00013" name="GHWEB00013"></a></p>

<h4><a id="sthref127" name="sthref127"></a>Edit Virtual Server</h4>
<a name="BEGIN" id="BEGIN"></a>
<p>Use the Edit Virtual Server page to modify the settings for a virtual server.</p>
<p>The Edit Virtual Server page contains the following options.</p>
<dl>
<dt>Load Defaults</dt>
<dd>
<p>Button to restore settings that have default values to their default values. Settings that do not have default values are not changed.</p>
</dd>
<dt>Configuration Name</dt>
<dd>
<p>The name of the configuration to which the settings on this page apply. This field is read only.</p>
</dd>
<dt>Id</dt>
<dd>
<p>Internally visible virtual server identifier. It is not exposed to HTTP clients. The host names that are exposed to HTTP clients must be specified in the Hosts field.</p>
</dd>
<dt>Hosts</dt>
<dd>
<p>The host name or names for the machine on which the server is running. Use either actual or virtual host names that are registered with the DNS server for your network (and, on a UNIX system, in your <code>/etc/hosts</code> file). The default value is the system property value <code>${com.sun.aas.hostName}</code>.</p>
</dd>
<dt>State</dt>
<dd>
<p>The desired state for the server. The value may be any of the following:</p>
<dl>
<dt>On</dt>
<dd>
<p>The virtual server is active. This value is the default.</p>
</dd>
<dt>Off</dt>
<dd>
<p>The virtual server is inactive. Attempts to access the server will return the error code 404 (resource not available).</p>
</dd>
<dt>Disabled</dt>
<dd>
<p>The virtual server is disabled. Attempts to access the server will return the error code 403 (refused to fulfill the request).</p>
</dd>
</dl>
</dd>
<dt>SSO</dt>
<dd>
<p>Specifies whether single sign-on behavior is inherited from the HTTP Service, enabled, or disabled. By default, it is inherited from the HTTP Service. If this option is enabled, single sign-on is enabled for web applications on this virtual server that are configured for the same realm. If this option is disabled, single sign-on is disabled for this virtual server, and users must authenticate separately to every application on the virtual server.</p>
</dd>
<dt>Network Listeners</dt>
<dd>
<p>The network listener or listeners associated with this server.</p>
</dd>
<dt>Default Web Module</dt>
<dd>
<p>The deployed web module (if any) that is to respond to all requests that cannot be mapped to other web modules deployed to the virtual server. If a Default Web Module is not specified, the web module that has an empty context root is used. If there is no web module with an empty context root, a system default web module is created and used.</p>
</dd>
<dt>Log File</dt>
<dd>
<p>The path name of the file where logging messages from this virtual server will appear. By default, logging messages will appear in <i>domain-dir</i><code>/logs/server.log</code>..</p>
</dd>
<dt>Docroot</dt>
<dd>
<p>The absolute path to the root document directory for the server. The default value is <i>domain-dir</i><code>/docroot</code>.</p>
</dd>
<dt>Access Logging</dt>
<dd>
<p>Specifies whether access logging is inherited from the HTTP Service, enabled, or disabled. By default, it is inherited from the HTTP Service.</p>
</dd>
<dt>Directory</dt>
<dd>
<p>The absolute directory path to the server access logs. The default is <i>domain-dir</i><code>/logs/access</code>.</p>
</dd>
<dt>Additional Properties</dt>
<dd>
<p>Additional properties for the virtual server.</p>
</dd>
</dl>
<a id="sthref128" name="sthref128"></a>
<h5>Related Tasks</h5>
<ul>
<li>
<p><a href="task-virtualservercreate.html">To Create a Virtual Server</a></p>
</li>
<li>
<p><a href="task-virtualserveredit.html">To Edit a Virtual Server</a></p>
</li>
<li>
<p><a href="task-virtualserverdelete.html">To Delete a Virtual Server</a></p>
</li>
</ul>
<a id="sthref129" name="sthref129"></a>
<h5>Related asadmin Commands</h5>
<ul>
<li>
<p><a href="/resource/reference/en/help/reference/create-virtual-server"><code>create-virtual-server</code>(1)</a></p>
</li>
<li>
<p><a href="/resource/reference/en/help/reference/list-virtual-servers"><code>list-virtual-servers</code>(1)</a></p>
</li>
<li>
<p><a href="/resource/reference/en/help/reference/delete-virtual-server"><code>delete-virtual-server</code>(1)</a></p>
</li>
</ul>



<small>Copyright &#169; 2005, 2017, Oracle and/or its affiliates. All rights reserved. <a href="docinfo.html">Legal Notices</a></small>
<small>Portions Copyright &#169; [2017-2020] Payara Foundation and/or affiliates.</small>
